============================================================================================================================
Modification Title: Portal System Addon: PayPal Donation Block v1.0

Author: Splen

Required: Portal System v2.4

Last Updated: 03/30/10

Description:
This modification will add a PayPal Donation Block to the Portal System.
It will give the user the option of adding their username if logged in or not.
It also gives the user the option of being listed as a benefactor.

Supported Version: XMB 1.9.5 SP1

Installation Note: Before adding this modification to your forum, you should back up all files related to this modification.

License Note: This modification is released under the GPL License. A copy is provided with this software package.

Note:  If you do not want your paypal email address to be viewable to spambots on the portal, you may use the email encoder at http://www.enlitence.com/modules.php?name=Email_Encoder
Also, you will have to change $paypal_email and $return settings in step #1
============================================================================================================================
=======
Step 1.
=======
================
Edit File: portal.php
================
==========
Find Code:
==========

'portal_quick_reg_password',
'portal_quick_reg'

================
Replace Code With:
================

'portal_quick_reg_password',
'portal_quick_reg',
'portal_paypal'

==========
Find Code:
==========

$sql = $db->query("SELECT p.*, t.* FROM $table_portal_templates p LEFT JOIN $table_templates t ON t.name = p.name WHERE p.status = 'on' ORDER BY p.displayorder ASC  LIMIT 0 , 30");

===============
Add Code Above:
===============

// Portal PayPal Mod Begin
$paypal_email="YOU@YOUR_EMAIL.com"; //Your paypal email address here
$message1 = "Feel Free to Donate<br />Give a one-time donation:";
$message2 = "Thank You";
$item = "Site Donations";
$itemn = "Donate to $bbname";
$return = "http://www.YOUR_DOMAIN.com"; //create a thank you page if you like or just a return page to your url
$for = "Donation is for";
// Portal PayPal Mod End

=================================
2. Go to Portal Admin --> Add Portal Blocks
=================================
==========================
Create Portal Block: portal_paypal
==========================
========================
Add Code and Submit Changes
========================

<table cellspacing="0" cellpadding="0" border="0" width="100%" bgcolor="$bordercolor">
<tr>
<td>
<table border="0" cellspacing="$borderwidth" cellpadding="$tablespace" width="100%">
<tr>
<td class="category" colspan="2"><strong><font color="$cattext">&raquo; $bbname Donation</font></strong></td>
</tr>
<tr>
<td bgcolor="$altbg2" class="ctrtablerow" colspan="2">
$message1
<form action="https://www.paypal.com/cgi-bin/webscr" target="paypal" method="post">
<input type="hidden" name="cmd" value="_xclick">
<input type="hidden" name="business" value="$paypal_email">
<input type="hidden" name="return" value="$return">
<input type="hidden" name="item_name" value="$item">
<input type="hidden" name="item_number" value="$itemn">
<input type="hidden" name="currency_code" value="USD">
<p align="left">
<input type="hidden" name="on0" value="Username">
&nbsp;&nbsp;Username:&nbsp;&nbsp; <input type="text" name="os0" size="10" value="$xmbuser"><br />
<input type="hidden" name="on1" value="--Note">
<input type="radio" name="os1" value="List me as a Benefactor">&nbsp; List me as a Benefactor<br />
<input type="radio" name="os1" value="Do not list me as a Benefactor">&nbsp; Do not list me as a Benefactor</p>
<input type="hidden" name="no_shipping" value="1">Amount<br />
$ <input type="text" name="amount" size="10"><br />
<input type="hidden" name="p3" value="1">
<input type="hidden" name="t3" value="M">
<input type="hidden" name="src" value="1">
<input type="hidden" name="sra" value="1">
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but21.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!"></form><br /></td></tr>
<tr>
<td class="category" colspan="2"><strong><font color="$cattext">&raquo; Set-up Monthly Donations</font></strong></td>
</tr>
<tr>
<td bgcolor="$altbg2" class="ctrtablerow" colspan="2">
<form action="https://www.paypal.com/cgi-bin/webscr" target="paypal" method="post">
<p align="left">
<input type="hidden" name="on0" value="Username">
&nbsp;&nbsp;Username:&nbsp;&nbsp; <input type="text" name="os0" size="10" value="$xmbuser"><br />
<input type="hidden" name="on1" value="--Note">
<input type="radio" name="os1" value="List me as a Benefactor">&nbsp; List me as a Benefactor<br />
<input type="radio" name="os1" value="Do not list me as a Benefactor">&nbsp; Do not list me as a Benefactor</p>
Please select an amount:
<input type="hidden" name="cmd" value="_xclick-subscriptions">
<input type="hidden" name="business" value="$paypal_email">
<input type="hidden" name="return" value="$return">
<input type="hidden" name="item_name" value="$item">
<input type="hidden" name="item_number" value="$itemn">
<input type="hidden" name="no_note" value="1">
<input type="hidden" name="currency_code" value="USD">
<input type="hidden" name="no_shipping" value="1">
<input type="hidden" name="rm" value="5"><br />
<select name="a3">
<option selected>Choose Amount</option>
<option value="$5.00">$5.00</option>
<option value="$10.00">$10.00</option>
<option value="$15.00">$15.00</option>
<option value="$20.00">$20.00</option>
<option value="$25.00">$25.00</option>
</select><br />
$for <select name="srt">
<option value="3">3</option>
<option value="6">6</option>
<option value="9">9</option>
<option value="12">12</option>
</select>months.<br />
<input type="hidden" name="p3" value="1">
<input type="hidden" name="t3" value="M">
<input type="hidden" name="src" value="1">
<input type="hidden" name="sra" value="1">
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but21.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form><br /><hr>
$message2<br /></td>
</tr>
</table>
</td>
</tr>
</table>

============================================================================================================================
Enjoy!